urllib.URLopener

Module urllib :: Class URLopener

[show private | hide private]

Class URLopener

Known Subclasses:: FancyURLopener

Class to open URLs. This is a class rather than just a subroutine because we may need more than one set of global protocol-specific options. Note -- this is a base class for those who don't want the automatic handling of errors type 302 (relocated) and 401 (authorization needed).

Method Summary
	`__init__(self, proxies, **x509)`
	`__del__(self)`
	`addheader(self, *args)` Add a header to be used by the HTTP interface only e.g.
	`cleanup(self)`
	`close(self)`
	`http_error(self, url, fp, errcode, errmsg, headers, data)` Handle http errors.
	`http_error_default(self, url, fp, errcode, errmsg, headers)` Default error handler: close the connection and raise IOError.
	`open(self, fullurl, data)` Use URLopener().open(file) instead of open(file, 'r').
	`open_data(self, url, data)` Use "data" URL.
	`open_file(self, url)` Use local file or FTP depending on form of URL.
	`open_ftp(self, url)` Use FTP protocol.
	`open_gopher(self, url)` Use Gopher protocol.
	`open_http(self, url, data)` Use HTTP protocol.
	`open_https(self, url, data)` Use HTTPS protocol.
	`open_local_file(self, url)` Use local file.
	`open_unknown(self, fullurl, data)` Overridable interface to open unknown URL type.
	`open_unknown_proxy(self, proxy, fullurl, data)` Overridable interface to open unknown URL type.
	`retrieve(self, url, filename, reporthook, data)` retrieve(url) returns (filename, headers) for a local object or (tempfilename, headers) for a remote object.

Class Variable Summary
`str`	`version` = `'Python-urllib/1.15'`
`NoneType`	`_URLopener__tempfiles` = None

Method Details

addheader(self, *args)

Add a header to be used by the HTTP interface only e.g. u.addheader('Accept', 'sound/basic')

http_error(self, url, fp, errcode, errmsg, headers, data=None)

Handle http errors. Derived class can override this, or provide specific handlers named http_error_DDD where DDD is the 3-digit error code.

http_error_default(self, url, fp, errcode, errmsg, headers)

Default error handler: close the connection and raise IOError.

open(self, fullurl, data=None)

Use URLopener().open(file) instead of open(file, 'r').

open_data(self, url, data=None)

Use "data" URL.

open_file(self, url)

Use local file or FTP depending on form of URL.

open_ftp(self, url)

Use FTP protocol.

open_gopher(self, url)

Use Gopher protocol.

open_http(self, url, data=None)

Use HTTP protocol.

open_https(self, url, data=None)

Use HTTPS protocol.

open_local_file(self, url)

Use local file.

open_unknown(self, fullurl, data=None)

Overridable interface to open unknown URL type.

open_unknown_proxy(self, proxy, fullurl, data=None)

Overridable interface to open unknown URL type.

retrieve(self, url, filename=None, reporthook=None, data=None)

retrieve(url) returns (filename, headers) for a local object or (tempfilename, headers) for a remote object.

Class Variable Details

version

Type:: str
Value:: 'Python-urllib/1.15'

_URLopener__tempfiles

Type:: NoneType
Value:: None

Generated by Epydoc 2.1 on Sun Jul 03 17:07:34 2005

http://epydoc.sf.net